<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>open_textwindow [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_legacy.html">过时</a> / <a href="toc_legacy_graphics.html">图形</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">open_textwindow</span><span data-if="c" style="display:none;">T_open_textwindow</span><span data-if="cpp" style="display:none;">OpenTextwindow</span><span data-if="dotnet" style="display:none;">OpenTextwindow</span><span data-if="python" style="display:none;">open_textwindow</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">open_textwindow</span><span data-if="c" style="display:none;">T_open_textwindow</span><span data-if="cpp" style="display:none;">OpenTextwindow</span><span data-if="dotnet" style="display:none;">OpenTextwindow</span><span data-if="python" style="display:none;">open_textwindow</span></code> — Open a textual window.</p>
<h2>警告</h2>
<p><b><code><span data-if="hdevelop" style="display:inline">open_textwindow</span><span data-if="c" style="display:none">open_textwindow</span><span data-if="cpp" style="display:none">OpenTextwindow</span><span data-if="com" style="display:none">OpenTextwindow</span><span data-if="dotnet" style="display:none">OpenTextwindow</span><span data-if="python" style="display:none">open_textwindow</span></code> is obsolete and is only provided for
reasons of backward compatibility. New applications should use the
operator <a href="open_window.html"><code><span data-if="hdevelop" style="display:inline">open_window</span><span data-if="c" style="display:none">open_window</span><span data-if="cpp" style="display:none">OpenWindow</span><span data-if="com" style="display:none">OpenWindow</span><span data-if="dotnet" style="display:none">OpenWindow</span><span data-if="python" style="display:none">open_window</span></code></a> instead.</b></p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>open_textwindow</b>( :  : <a href="#Row"><i>Row</i></a>, <a href="#Column"><i>Column</i></a>, <a href="#Width"><i>Width</i></a>, <a href="#Height"><i>Height</i></a>, <a href="#BorderWidth"><i>BorderWidth</i></a>, <a href="#BorderColor"><i>BorderColor</i></a>, <a href="#BackgroundColor"><i>BackgroundColor</i></a>, <a href="#FatherWindow"><i>FatherWindow</i></a>, <a href="#Mode"><i>Mode</i></a>, <a href="#Machine"><i>Machine</i></a> : <a href="#WindowHandle"><i>WindowHandle</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_open_textwindow</b>(const Htuple <a href="#Row"><i>Row</i></a>, const Htuple <a href="#Column"><i>Column</i></a>, const Htuple <a href="#Width"><i>Width</i></a>, const Htuple <a href="#Height"><i>Height</i></a>, const Htuple <a href="#BorderWidth"><i>BorderWidth</i></a>, const Htuple <a href="#BorderColor"><i>BorderColor</i></a>, const Htuple <a href="#BackgroundColor"><i>BackgroundColor</i></a>, const Htuple <a href="#FatherWindow"><i>FatherWindow</i></a>, const Htuple <a href="#Mode"><i>Mode</i></a>, const Htuple <a href="#Machine"><i>Machine</i></a>, Htuple* <a href="#WindowHandle"><i>WindowHandle</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>OpenTextwindow</b>(const HTuple&amp; <a href="#Row"><i>Row</i></a>, const HTuple&amp; <a href="#Column"><i>Column</i></a>, const HTuple&amp; <a href="#Width"><i>Width</i></a>, const HTuple&amp; <a href="#Height"><i>Height</i></a>, const HTuple&amp; <a href="#BorderWidth"><i>BorderWidth</i></a>, const HTuple&amp; <a href="#BorderColor"><i>BorderColor</i></a>, const HTuple&amp; <a href="#BackgroundColor"><i>BackgroundColor</i></a>, const HTuple&amp; <a href="#FatherWindow"><i>FatherWindow</i></a>, const HTuple&amp; <a href="#Mode"><i>Mode</i></a>, const HTuple&amp; <a href="#Machine"><i>Machine</i></a>, HTuple* <a href="#WindowHandle"><i>WindowHandle</i></a>)</code></p>
<p>
<code>void <a href="HWindow.html">HWindow</a>::<b>OpenTextwindow</b>(Hlong <a href="#Row"><i>Row</i></a>, Hlong <a href="#Column"><i>Column</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>, Hlong <a href="#BorderWidth"><i>BorderWidth</i></a>, const HString&amp; <a href="#BorderColor"><i>BorderColor</i></a>, const HString&amp; <a href="#BackgroundColor"><i>BackgroundColor</i></a>, const HTuple&amp; <a href="#FatherWindow"><i>FatherWindow</i></a>, const HString&amp; <a href="#Mode"><i>Mode</i></a>, const HString&amp; <a href="#Machine"><i>Machine</i></a>)</code></p>
<p>
<code>void <a href="HWindow.html">HWindow</a>::<b>OpenTextwindow</b>(Hlong <a href="#Row"><i>Row</i></a>, Hlong <a href="#Column"><i>Column</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>, Hlong <a href="#BorderWidth"><i>BorderWidth</i></a>, const HString&amp; <a href="#BorderColor"><i>BorderColor</i></a>, const HString&amp; <a href="#BackgroundColor"><i>BackgroundColor</i></a>, void* <a href="#FatherWindow"><i>FatherWindow</i></a>, const HString&amp; <a href="#Mode"><i>Mode</i></a>, const HString&amp; <a href="#Machine"><i>Machine</i></a>)</code></p>
<p>
<code>void <a href="HWindow.html">HWindow</a>::<b>OpenTextwindow</b>(Hlong <a href="#Row"><i>Row</i></a>, Hlong <a href="#Column"><i>Column</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>, Hlong <a href="#BorderWidth"><i>BorderWidth</i></a>, const char* <a href="#BorderColor"><i>BorderColor</i></a>, const char* <a href="#BackgroundColor"><i>BackgroundColor</i></a>, void* <a href="#FatherWindow"><i>FatherWindow</i></a>, const char* <a href="#Mode"><i>Mode</i></a>, const char* <a href="#Machine"><i>Machine</i></a>)</code></p>
<p>
<code>void <a href="HWindow.html">HWindow</a>::<b>OpenTextwindow</b>(Hlong <a href="#Row"><i>Row</i></a>, Hlong <a href="#Column"><i>Column</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>, Hlong <a href="#BorderWidth"><i>BorderWidth</i></a>, const wchar_t* <a href="#BorderColor"><i>BorderColor</i></a>, const wchar_t* <a href="#BackgroundColor"><i>BackgroundColor</i></a>, void* <a href="#FatherWindow"><i>FatherWindow</i></a>, const wchar_t* <a href="#Mode"><i>Mode</i></a>, const wchar_t* <a href="#Machine"><i>Machine</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>OpenTextwindow</b>(<a href="HTuple.html">HTuple</a> <a href="#Row"><i>row</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Column"><i>column</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Width"><i>width</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Height"><i>height</i></a>, <a href="HTuple.html">HTuple</a> <a href="#BorderWidth"><i>borderWidth</i></a>, <a href="HTuple.html">HTuple</a> <a href="#BorderColor"><i>borderColor</i></a>, <a href="HTuple.html">HTuple</a> <a href="#BackgroundColor"><i>backgroundColor</i></a>, <a href="HTuple.html">HTuple</a> <a href="#FatherWindow"><i>fatherWindow</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Mode"><i>mode</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Machine"><i>machine</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#WindowHandle"><i>windowHandle</i></a>)</code></p>
<p>
<code>void <a href="HWindow.html">HWindow</a>.<b>OpenTextwindow</b>(int <a href="#Row"><i>row</i></a>, int <a href="#Column"><i>column</i></a>, int <a href="#Width"><i>width</i></a>, int <a href="#Height"><i>height</i></a>, int <a href="#BorderWidth"><i>borderWidth</i></a>, string <a href="#BorderColor"><i>borderColor</i></a>, string <a href="#BackgroundColor"><i>backgroundColor</i></a>, <a href="HTuple.html">HTuple</a> <a href="#FatherWindow"><i>fatherWindow</i></a>, string <a href="#Mode"><i>mode</i></a>, string <a href="#Machine"><i>machine</i></a>)</code></p>
<p>
<code>void <a href="HWindow.html">HWindow</a>.<b>OpenTextwindow</b>(int <a href="#Row"><i>row</i></a>, int <a href="#Column"><i>column</i></a>, int <a href="#Width"><i>width</i></a>, int <a href="#Height"><i>height</i></a>, int <a href="#BorderWidth"><i>borderWidth</i></a>, string <a href="#BorderColor"><i>borderColor</i></a>, string <a href="#BackgroundColor"><i>backgroundColor</i></a>, IntPtr <a href="#FatherWindow"><i>fatherWindow</i></a>, string <a href="#Mode"><i>mode</i></a>, string <a href="#Machine"><i>machine</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>open_textwindow</b>(<a href="#Row"><i>row</i></a>: int, <a href="#Column"><i>column</i></a>: int, <a href="#Width"><i>width</i></a>: int, <a href="#Height"><i>height</i></a>: int, <a href="#BorderWidth"><i>border_width</i></a>: int, <a href="#BorderColor"><i>border_color</i></a>: str, <a href="#BackgroundColor"><i>background_color</i></a>: str, <a href="#FatherWindow"><i>father_window</i></a>: Union[int, str], <a href="#Mode"><i>mode</i></a>: str, <a href="#Machine"><i>machine</i></a>: str) -&gt; HHandle</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">open_textwindow</span><span data-if="c" style="display:none">open_textwindow</span><span data-if="cpp" style="display:none">OpenTextwindow</span><span data-if="com" style="display:none">OpenTextwindow</span><span data-if="dotnet" style="display:none">OpenTextwindow</span><span data-if="python" style="display:none">open_textwindow</span></code> opens a new textual window, which can be
used to perform textual input and output, as well as to perform
output of images. All output (<a href="write_string.html"><code><span data-if="hdevelop" style="display:inline">write_string</span><span data-if="c" style="display:none">write_string</span><span data-if="cpp" style="display:none">WriteString</span><span data-if="com" style="display:none">WriteString</span><span data-if="dotnet" style="display:none">WriteString</span><span data-if="python" style="display:none">write_string</span></code></a>, <a href="read_string.html"><code><span data-if="hdevelop" style="display:inline">read_string</span><span data-if="c" style="display:none">read_string</span><span data-if="cpp" style="display:none">ReadString</span><span data-if="com" style="display:none">ReadString</span><span data-if="dotnet" style="display:none">ReadString</span><span data-if="python" style="display:none">read_string</span></code></a>,
<a href="disp_region.html"><code><span data-if="hdevelop" style="display:inline">disp_region</span><span data-if="c" style="display:none">disp_region</span><span data-if="cpp" style="display:none">DispRegion</span><span data-if="com" style="display:none">DispRegion</span><span data-if="dotnet" style="display:none">DispRegion</span><span data-if="python" style="display:none">disp_region</span></code></a>, etc.) is redirected to this window, if the same
logical window number <a href="#WindowHandle"><i><code><span data-if="hdevelop" style="display:inline">WindowHandle</span><span data-if="c" style="display:none">WindowHandle</span><span data-if="cpp" style="display:none">WindowHandle</span><span data-if="com" style="display:none">WindowHandle</span><span data-if="dotnet" style="display:none">windowHandle</span><span data-if="python" style="display:none">window_handle</span></code></i></a> is used.
</p>
<p>Besides the mouse cursor textual windows possess also a textual cursor which
indicates the current writing position (more exactly: the lower left corner
of the output string without consideration of descenders). Its position
is indicated through an underscore or another type (the indication of
this position may also be disabled (= default setting);
cf. <a href="set_tshape.html"><code><span data-if="hdevelop" style="display:inline">set_tshape</span><span data-if="c" style="display:none">set_tshape</span><span data-if="cpp" style="display:none">SetTshape</span><span data-if="com" style="display:none">SetTshape</span><span data-if="dotnet" style="display:none">SetTshape</span><span data-if="python" style="display:none">set_tshape</span></code></a>).
You may set or query the position by calling 该算子s
<a href="set_tposition.html"><code><span data-if="hdevelop" style="display:inline">set_tposition</span><span data-if="c" style="display:none">set_tposition</span><span data-if="cpp" style="display:none">SetTposition</span><span data-if="com" style="display:none">SetTposition</span><span data-if="dotnet" style="display:none">SetTposition</span><span data-if="python" style="display:none">set_tposition</span></code></a> or <a href="get_tposition.html"><code><span data-if="hdevelop" style="display:inline">get_tposition</span><span data-if="c" style="display:none">get_tposition</span><span data-if="cpp" style="display:none">GetTposition</span><span data-if="com" style="display:none">GetTposition</span><span data-if="dotnet" style="display:none">GetTposition</span><span data-if="python" style="display:none">get_tposition</span></code></a>.
</p>
<p>After you opened a textual window the position of the cursor is set to
(H,0). Whereby H signifies the height of the default font less the
descenders. But the cursor is not shown. Hence the output starts for
writing in the upper left corner of the window.
</p>
<p>You may query the colors of the background and the image edges by
calling <a href="query_color.html"><code><span data-if="hdevelop" style="display:inline">query_color</span><span data-if="c" style="display:none">query_color</span><span data-if="cpp" style="display:none">QueryColor</span><span data-if="com" style="display:none">QueryColor</span><span data-if="dotnet" style="display:none">QueryColor</span><span data-if="python" style="display:none">query_color</span></code></a>. In the same way you may use
<a href="query_color.html"><code><span data-if="hdevelop" style="display:inline">query_color</span><span data-if="c" style="display:none">query_color</span><span data-if="cpp" style="display:none">QueryColor</span><span data-if="com" style="display:none">QueryColor</span><span data-if="dotnet" style="display:none">QueryColor</span><span data-if="python" style="display:none">query_color</span></code></a> in a window of type 'invisible'.
During output (<a href="write_string.html"><code><span data-if="hdevelop" style="display:inline">write_string</span><span data-if="c" style="display:none">write_string</span><span data-if="cpp" style="display:none">WriteString</span><span data-if="com" style="display:none">WriteString</span><span data-if="dotnet" style="display:none">WriteString</span><span data-if="python" style="display:none">write_string</span></code></a>) you may set the clipping
of text out of the window edges by calling <a href="set_check.html"><code><span data-if="hdevelop" style="display:inline">set_check(::'~text':)</span><span data-if="c" style="display:none">set_check("~text")</span><span data-if="cpp" style="display:none">SetCheck("~text")</span><span data-if="com" style="display:none">SetCheck("~text")</span><span data-if="dotnet" style="display:none">SetCheck("~text")</span><span data-if="python" style="display:none">set_check("~text")</span></code></a>.
This disables the creation of error messages, if text passes over
the edge of the window.
</p>
<p>The origin of the coordinate system of the window resides in the
upper left corner (coordinates: (0,0)). The row index grows
downward (maximal: <a href="#Height"><i><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></i></a>-1), the column index grows
to the right (maximal: <a href="#Width"><i><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></i></a>-1).
</p>
<p>The parameter <a href="#Machine"><i><code><span data-if="hdevelop" style="display:inline">Machine</span><span data-if="c" style="display:none">Machine</span><span data-if="cpp" style="display:none">Machine</span><span data-if="com" style="display:none">Machine</span><span data-if="dotnet" style="display:none">machine</span><span data-if="python" style="display:none">machine</span></code></i></a> indicates the name of the computer,
which has to open the window. In case of a X-window, TCP-IP only sets
the name, DEC-Net sets in addition a colon behind the name. The
“server” or the “screen”, respectively, are not specified.
If the empty string is passed the environment variable
DISPLAY is used. It indicates the target computer. At this the name
is indicated in common syntax &lt;Host&gt;:0.0.
</p>
<p>For windows of type <i><span data-if="hdevelop" style="display:inline">'WIN32-Window'</span><span data-if="c" style="display:none">"WIN32-Window"</span><span data-if="cpp" style="display:none">"WIN32-Window"</span><span data-if="com" style="display:none">"WIN32-Window"</span><span data-if="dotnet" style="display:none">"WIN32-Window"</span><span data-if="python" style="display:none">"WIN32-Window"</span></i> and <i><span data-if="hdevelop" style="display:inline">'X-Window'</span><span data-if="c" style="display:none">"X-Window"</span><span data-if="cpp" style="display:none">"X-Window"</span><span data-if="com" style="display:none">"X-Window"</span><span data-if="dotnet" style="display:none">"X-Window"</span><span data-if="python" style="display:none">"X-Window"</span></i>
the parameter <a href="#FatherWindow"><i><code><span data-if="hdevelop" style="display:inline">FatherWindow</span><span data-if="c" style="display:none">FatherWindow</span><span data-if="cpp" style="display:none">FatherWindow</span><span data-if="com" style="display:none">FatherWindow</span><span data-if="dotnet" style="display:none">fatherWindow</span><span data-if="python" style="display:none">father_window</span></code></i></a> can be used to determine the father
window for the window to be opened. In case the control 'father' is set via
<a href="set_check.html"><code><span data-if="hdevelop" style="display:inline">set_check</span><span data-if="c" style="display:none">set_check</span><span data-if="cpp" style="display:none">SetCheck</span><span data-if="com" style="display:none">SetCheck</span><span data-if="dotnet" style="display:none">SetCheck</span><span data-if="python" style="display:none">set_check</span></code></a>, <a href="#FatherWindow"><i><code><span data-if="hdevelop" style="display:inline">FatherWindow</span><span data-if="c" style="display:none">FatherWindow</span><span data-if="cpp" style="display:none">FatherWindow</span><span data-if="com" style="display:none">FatherWindow</span><span data-if="dotnet" style="display:none">fatherWindow</span><span data-if="python" style="display:none">father_window</span></code></i></a> must be the ID of a HALCON window,
otherwise (<a href="set_check.html"><code><span data-if="hdevelop" style="display:inline">set_check(::'~father':)</span><span data-if="c" style="display:none">set_check("~father")</span><span data-if="cpp" style="display:none">SetCheck("~father")</span><span data-if="com" style="display:none">SetCheck("~father")</span><span data-if="dotnet" style="display:none">SetCheck("~father")</span><span data-if="python" style="display:none">set_check("~father")</span></code></a>)
it can also be the ID of an operating system window. If <a href="#FatherWindow"><i><code><span data-if="hdevelop" style="display:inline">FatherWindow</span><span data-if="c" style="display:none">FatherWindow</span><span data-if="cpp" style="display:none">FatherWindow</span><span data-if="com" style="display:none">FatherWindow</span><span data-if="dotnet" style="display:none">fatherWindow</span><span data-if="python" style="display:none">father_window</span></code></i></a>
is passed the value 0 or 'root', then under Windows and Unix-like systems the
desktop and the root window become the father window, respectively. In this
case, the value of the control 'father' (set via <a href="set_check.html"><code><span data-if="hdevelop" style="display:inline">set_check</span><span data-if="c" style="display:none">set_check</span><span data-if="cpp" style="display:none">SetCheck</span><span data-if="com" style="display:none">SetCheck</span><span data-if="dotnet" style="display:none">SetCheck</span><span data-if="python" style="display:none">set_check</span></code></a>) is
irrelevant. The caller must ensure that <a href="#FatherWindow"><i><code><span data-if="hdevelop" style="display:inline">FatherWindow</span><span data-if="c" style="display:none">FatherWindow</span><span data-if="cpp" style="display:none">FatherWindow</span><span data-if="com" style="display:none">FatherWindow</span><span data-if="dotnet" style="display:none">fatherWindow</span><span data-if="python" style="display:none">father_window</span></code></i></a> is a valid
handle and not destroyed as long as the embedded HALCON window is used.
</p>
<p>Position and size of a window may change during runtime of a program.
This may be achieved by calling <a href="set_window_extents.html"><code><span data-if="hdevelop" style="display:inline">set_window_extents</span><span data-if="c" style="display:none">set_window_extents</span><span data-if="cpp" style="display:none">SetWindowExtents</span><span data-if="com" style="display:none">SetWindowExtents</span><span data-if="dotnet" style="display:none">SetWindowExtents</span><span data-if="python" style="display:none">set_window_extents</span></code></a>, but
also through external interferences (window manager). In the latter
case 该算子 <a href="set_window_extents.html"><code><span data-if="hdevelop" style="display:inline">set_window_extents</span><span data-if="c" style="display:none">set_window_extents</span><span data-if="cpp" style="display:none">SetWindowExtents</span><span data-if="com" style="display:none">SetWindowExtents</span><span data-if="dotnet" style="display:none">SetWindowExtents</span><span data-if="python" style="display:none">set_window_extents</span></code></a> is provided.
</p>
<p>Opening a window causes the assignment of a called default font.
It is used in connection with operators like <a href="write_string.html"><code><span data-if="hdevelop" style="display:inline">write_string</span><span data-if="c" style="display:none">write_string</span><span data-if="cpp" style="display:none">WriteString</span><span data-if="com" style="display:none">WriteString</span><span data-if="dotnet" style="display:none">WriteString</span><span data-if="python" style="display:none">write_string</span></code></a>
and you may overwrite it by performing <a href="set_font.html"><code><span data-if="hdevelop" style="display:inline">set_font</span><span data-if="c" style="display:none">set_font</span><span data-if="cpp" style="display:none">SetFont</span><span data-if="com" style="display:none">SetFont</span><span data-if="dotnet" style="display:none">SetFont</span><span data-if="python" style="display:none">set_font</span></code></a> after
calling <code><span data-if="hdevelop" style="display:inline">open_textwindow</span><span data-if="c" style="display:none">open_textwindow</span><span data-if="cpp" style="display:none">OpenTextwindow</span><span data-if="com" style="display:none">OpenTextwindow</span><span data-if="dotnet" style="display:none">OpenTextwindow</span><span data-if="python" style="display:none">open_textwindow</span></code>. On the other hand you have the
possibility to specify a default font by calling
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'default_font',&lt;Fontname&gt;:)</span><span data-if="c" style="display:none">set_system("default_font",&lt;Fontname&gt;)</span><span data-if="cpp" style="display:none">SetSystem("default_font",&lt;Fontname&gt;)</span><span data-if="com" style="display:none">SetSystem("default_font",&lt;Fontname&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("default_font",&lt;Fontname&gt;)</span><span data-if="python" style="display:none">set_system("default_font",&lt;Fontname&gt;)</span></code></a> before opening
a window (and all following windows; see also <a href="query_font.html"><code><span data-if="hdevelop" style="display:inline">query_font</span><span data-if="c" style="display:none">query_font</span><span data-if="cpp" style="display:none">QueryFont</span><span data-if="com" style="display:none">QueryFont</span><span data-if="dotnet" style="display:none">QueryFont</span><span data-if="python" style="display:none">query_font</span></code></a>).
</p>
<p>You may set the color of the font (<a href="write_string.html"><code><span data-if="hdevelop" style="display:inline">write_string</span><span data-if="c" style="display:none">write_string</span><span data-if="cpp" style="display:none">WriteString</span><span data-if="com" style="display:none">WriteString</span><span data-if="dotnet" style="display:none">WriteString</span><span data-if="python" style="display:none">write_string</span></code></a>,
<a href="read_string.html"><code><span data-if="hdevelop" style="display:inline">read_string</span><span data-if="c" style="display:none">read_string</span><span data-if="cpp" style="display:none">ReadString</span><span data-if="com" style="display:none">ReadString</span><span data-if="dotnet" style="display:none">ReadString</span><span data-if="python" style="display:none">read_string</span></code></a>) by calling <a href="set_color.html"><code><span data-if="hdevelop" style="display:inline">set_color</span><span data-if="c" style="display:none">set_color</span><span data-if="cpp" style="display:none">SetColor</span><span data-if="com" style="display:none">SetColor</span><span data-if="dotnet" style="display:none">SetColor</span><span data-if="python" style="display:none">set_color</span></code></a>,
<a href="set_rgb.html"><code><span data-if="hdevelop" style="display:inline">set_rgb</span><span data-if="c" style="display:none">set_rgb</span><span data-if="cpp" style="display:none">SetRgb</span><span data-if="com" style="display:none">SetRgb</span><span data-if="dotnet" style="display:none">SetRgb</span><span data-if="python" style="display:none">set_rgb</span></code></a>, <a href="set_hsi.html"><code><span data-if="hdevelop" style="display:inline">set_hsi</span><span data-if="c" style="display:none">set_hsi</span><span data-if="cpp" style="display:none">SetHsi</span><span data-if="com" style="display:none">SetHsi</span><span data-if="dotnet" style="display:none">SetHsi</span><span data-if="python" style="display:none">set_hsi</span></code></a> or <a href="set_gray.html"><code><span data-if="hdevelop" style="display:inline">set_gray</span><span data-if="c" style="display:none">set_gray</span><span data-if="cpp" style="display:none">SetGray</span><span data-if="com" style="display:none">SetGray</span><span data-if="dotnet" style="display:none">SetGray</span><span data-if="python" style="display:none">set_gray</span></code></a>.
Calling <a href="set_insert.html"><code><span data-if="hdevelop" style="display:inline">set_insert</span><span data-if="c" style="display:none">set_insert</span><span data-if="cpp" style="display:none">SetInsert</span><span data-if="com" style="display:none">SetInsert</span><span data-if="dotnet" style="display:none">SetInsert</span><span data-if="python" style="display:none">set_insert</span></code></a> specifies how the text or the
graphics, respectively, is combined with the content of the image repeat memory.
So you may achieve by calling, e.g., <a href="set_insert.html"><code><span data-if="hdevelop" style="display:inline">set_insert</span><span data-if="c" style="display:none">set_insert</span><span data-if="cpp" style="display:none">SetInsert</span><span data-if="com" style="display:none">SetInsert</span><span data-if="dotnet" style="display:none">SetInsert</span><span data-if="python" style="display:none">set_insert</span></code></a>(::'not':)
to eliminate the font after writing text twice at the same position.
</p>
<p>Normally every output (e.g., <a href="write_string.html"><code><span data-if="hdevelop" style="display:inline">write_string</span><span data-if="c" style="display:none">write_string</span><span data-if="cpp" style="display:none">WriteString</span><span data-if="com" style="display:none">WriteString</span><span data-if="dotnet" style="display:none">WriteString</span><span data-if="python" style="display:none">write_string</span></code></a>, <a href="disp_region.html"><code><span data-if="hdevelop" style="display:inline">disp_region</span><span data-if="c" style="display:none">disp_region</span><span data-if="cpp" style="display:none">DispRegion</span><span data-if="com" style="display:none">DispRegion</span><span data-if="dotnet" style="display:none">DispRegion</span><span data-if="python" style="display:none">disp_region</span></code></a>,
<a href="disp_circle.html"><code><span data-if="hdevelop" style="display:inline">disp_circle</span><span data-if="c" style="display:none">disp_circle</span><span data-if="cpp" style="display:none">DispCircle</span><span data-if="com" style="display:none">DispCircle</span><span data-if="dotnet" style="display:none">DispCircle</span><span data-if="python" style="display:none">disp_circle</span></code></a>, etc.) in a window is terminated by a
“flush”. This causes the data to be fully visible on the display after
termination of the output operator. But this is not necessary in all
cases, in particular if there are permanently output tasks or there
is a mouse procedure active. Therefore it is more favorable (i.e., more
rapid) to store the data until sufficient data is available. You may
stop this behavior by calling <a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'flush_graphic','false':)</span><span data-if="c" style="display:none">set_system("flush_graphic","false")</span><span data-if="cpp" style="display:none">SetSystem("flush_graphic","false")</span><span data-if="com" style="display:none">SetSystem("flush_graphic","false")</span><span data-if="dotnet" style="display:none">SetSystem("flush_graphic","false")</span><span data-if="python" style="display:none">set_system("flush_graphic","false")</span></code></a>.
</p>
<p>The content of windows is saved (in case it is supported by special driver
software); i.e., it is preserved, also if the window is hidden by other
windows. But this is not necessary in all cases:
If you use a textual window, e.g., as a parent window for other windows, you
may suppress the security mechanism for it and save the necessary memory at
the same moment. You achieve this before opening the window by calling
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'backing_store','false':)</span><span data-if="c" style="display:none">set_system("backing_store","false")</span><span data-if="cpp" style="display:none">SetSystem("backing_store","false")</span><span data-if="com" style="display:none">SetSystem("backing_store","false")</span><span data-if="dotnet" style="display:none">SetSystem("backing_store","false")</span><span data-if="python" style="display:none">set_system("backing_store","false")</span></code></a>.
</p>
<p>
Difference: graphical window - textual window
</p>
<ul>
<li>
<p>
In contrast to graphical windows (<a href="open_window.html"><code><span data-if="hdevelop" style="display:inline">open_window</span><span data-if="c" style="display:none">open_window</span><span data-if="cpp" style="display:none">OpenWindow</span><span data-if="com" style="display:none">OpenWindow</span><span data-if="dotnet" style="display:none">OpenWindow</span><span data-if="python" style="display:none">open_window</span></code></a>) you may
specify more parameters (color, edge) for a textual window while
opening it.
</p>
</li>
<li>
<p>
You may use textual windows only for input of user data
(<a href="read_string.html"><code><span data-if="hdevelop" style="display:inline">read_string</span><span data-if="c" style="display:none">read_string</span><span data-if="cpp" style="display:none">ReadString</span><span data-if="com" style="display:none">ReadString</span><span data-if="dotnet" style="display:none">ReadString</span><span data-if="python" style="display:none">read_string</span></code></a>).
</p>
</li>
<li>
<p>
Using textual windows, the output of images, regions and graphics
is “clipped” at the edges. Whereas during the use of graphical
windows the edges are “zoomed”.
</p>
</li>
<li>
<p>
The coordinate system (e.g., with <a href="get_mbutton.html"><code><span data-if="hdevelop" style="display:inline">get_mbutton</span><span data-if="c" style="display:none">get_mbutton</span><span data-if="cpp" style="display:none">GetMbutton</span><span data-if="com" style="display:none">GetMbutton</span><span data-if="dotnet" style="display:none">GetMbutton</span><span data-if="python" style="display:none">get_mbutton</span></code></a> or
<a href="get_mposition.html"><code><span data-if="hdevelop" style="display:inline">get_mposition</span><span data-if="c" style="display:none">get_mposition</span><span data-if="cpp" style="display:none">GetMposition</span><span data-if="com" style="display:none">GetMposition</span><span data-if="dotnet" style="display:none">GetMposition</span><span data-if="python" style="display:none">get_mposition</span></code></a>) consists of display coordinates independently
of image size. The maximum coordinates are equal to the size of the
window minus 1. In contrast to this, graphical windows (<a href="open_window.html"><code><span data-if="hdevelop" style="display:inline">open_window</span><span data-if="c" style="display:none">open_window</span><span data-if="cpp" style="display:none">OpenWindow</span><span data-if="com" style="display:none">OpenWindow</span><span data-if="dotnet" style="display:none">OpenWindow</span><span data-if="python" style="display:none">open_window</span></code></a>)
use always a coordinate system, which corresponds to the image format.
</p>
</li>
</ul>
<p>

</p>
<p>The parameter <a href="#Mode"><i><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></i></a> specifies the mode of the window.
It can have following values:
</p>
<dl class="generic">

<dt><b>'visible':</b></dt>
<dd>
<p>

Normal mode for textual windows: The window is created according to
the parameters and all inputs and outputs are possible.
</p>
</dd>

<dt><b>'invisible':</b></dt>
<dd>
<p>

Invisible windows are not displayed in the display. Parameters like
<a href="#Row"><i><code><span data-if="hdevelop" style="display:inline">Row</span><span data-if="c" style="display:none">Row</span><span data-if="cpp" style="display:none">Row</span><span data-if="com" style="display:none">Row</span><span data-if="dotnet" style="display:none">row</span><span data-if="python" style="display:none">row</span></code></i></a>, <a href="#Column"><i><code><span data-if="hdevelop" style="display:inline">Column</span><span data-if="c" style="display:none">Column</span><span data-if="cpp" style="display:none">Column</span><span data-if="com" style="display:none">Column</span><span data-if="dotnet" style="display:none">column</span><span data-if="python" style="display:none">column</span></code></i></a>, <a href="#BorderWidth"><i><code><span data-if="hdevelop" style="display:inline">BorderWidth</span><span data-if="c" style="display:none">BorderWidth</span><span data-if="cpp" style="display:none">BorderWidth</span><span data-if="com" style="display:none">BorderWidth</span><span data-if="dotnet" style="display:none">borderWidth</span><span data-if="python" style="display:none">border_width</span></code></i></a>,
<a href="#BorderColor"><i><code><span data-if="hdevelop" style="display:inline">BorderColor</span><span data-if="c" style="display:none">BorderColor</span><span data-if="cpp" style="display:none">BorderColor</span><span data-if="com" style="display:none">BorderColor</span><span data-if="dotnet" style="display:none">borderColor</span><span data-if="python" style="display:none">border_color</span></code></i></a>, <a href="#BackgroundColor"><i><code><span data-if="hdevelop" style="display:inline">BackgroundColor</span><span data-if="c" style="display:none">BackgroundColor</span><span data-if="cpp" style="display:none">BackgroundColor</span><span data-if="com" style="display:none">BackgroundColor</span><span data-if="dotnet" style="display:none">backgroundColor</span><span data-if="python" style="display:none">background_color</span></code></i></a> and
<a href="#FatherWindow"><i><code><span data-if="hdevelop" style="display:inline">FatherWindow</span><span data-if="c" style="display:none">FatherWindow</span><span data-if="cpp" style="display:none">FatherWindow</span><span data-if="com" style="display:none">FatherWindow</span><span data-if="dotnet" style="display:none">fatherWindow</span><span data-if="python" style="display:none">father_window</span></code></i></a> do not have any meaning. Output to these
windows has no effect. Input (<a href="read_string.html"><code><span data-if="hdevelop" style="display:inline">read_string</span><span data-if="c" style="display:none">read_string</span><span data-if="cpp" style="display:none">ReadString</span><span data-if="com" style="display:none">ReadString</span><span data-if="dotnet" style="display:none">ReadString</span><span data-if="python" style="display:none">read_string</span></code></a>, mouse, etc.)
is not possible.
You may use these windows to query representation parameter for an
output device without opening a (visible) window.
General queries are, e.g., <a href="query_color.html"><code><span data-if="hdevelop" style="display:inline">query_color</span><span data-if="c" style="display:none">query_color</span><span data-if="cpp" style="display:none">QueryColor</span><span data-if="com" style="display:none">QueryColor</span><span data-if="dotnet" style="display:none">QueryColor</span><span data-if="python" style="display:none">query_color</span></code></a> and
<a href="get_string_extents.html"><code><span data-if="hdevelop" style="display:inline">get_string_extents</span><span data-if="c" style="display:none">get_string_extents</span><span data-if="cpp" style="display:none">GetStringExtents</span><span data-if="com" style="display:none">GetStringExtents</span><span data-if="dotnet" style="display:none">GetStringExtents</span><span data-if="python" style="display:none">get_string_extents</span></code></a>.
</p>
</dd>

<dt><b>'transparent':</b></dt>
<dd>
<p>

These windows are transparent: the window itself is not visible
(edge and background), but all the other operations are possible
and all output is displayed.
Parameters like <a href="#BorderColor"><i><code><span data-if="hdevelop" style="display:inline">BorderColor</span><span data-if="c" style="display:none">BorderColor</span><span data-if="cpp" style="display:none">BorderColor</span><span data-if="com" style="display:none">BorderColor</span><span data-if="dotnet" style="display:none">borderColor</span><span data-if="python" style="display:none">border_color</span></code></i></a> and <a href="#BackgroundColor"><i><code><span data-if="hdevelop" style="display:inline">BackgroundColor</span><span data-if="c" style="display:none">BackgroundColor</span><span data-if="cpp" style="display:none">BackgroundColor</span><span data-if="com" style="display:none">BackgroundColor</span><span data-if="dotnet" style="display:none">backgroundColor</span><span data-if="python" style="display:none">background_color</span></code></i></a>
do not have any meaning.
A common use for this mode is the creation of mouse sensitive regions.
</p>
</dd>

<dt><b>'buffer':</b></dt>
<dd><p>

These are also not visible windows. The output of images, regions and
graphics is not visible on the display, but is stored in memory.
Parameters like <a href="#Row"><i><code><span data-if="hdevelop" style="display:inline">Row</span><span data-if="c" style="display:none">Row</span><span data-if="cpp" style="display:none">Row</span><span data-if="com" style="display:none">Row</span><span data-if="dotnet" style="display:none">row</span><span data-if="python" style="display:none">row</span></code></i></a>, <a href="#Column"><i><code><span data-if="hdevelop" style="display:inline">Column</span><span data-if="c" style="display:none">Column</span><span data-if="cpp" style="display:none">Column</span><span data-if="com" style="display:none">Column</span><span data-if="dotnet" style="display:none">column</span><span data-if="python" style="display:none">column</span></code></i></a>, <a href="#BorderWidth"><i><code><span data-if="hdevelop" style="display:inline">BorderWidth</span><span data-if="c" style="display:none">BorderWidth</span><span data-if="cpp" style="display:none">BorderWidth</span><span data-if="com" style="display:none">BorderWidth</span><span data-if="dotnet" style="display:none">borderWidth</span><span data-if="python" style="display:none">border_width</span></code></i></a>,
<a href="#BorderColor"><i><code><span data-if="hdevelop" style="display:inline">BorderColor</span><span data-if="c" style="display:none">BorderColor</span><span data-if="cpp" style="display:none">BorderColor</span><span data-if="com" style="display:none">BorderColor</span><span data-if="dotnet" style="display:none">borderColor</span><span data-if="python" style="display:none">border_color</span></code></i></a>, <a href="#BackgroundColor"><i><code><span data-if="hdevelop" style="display:inline">BackgroundColor</span><span data-if="c" style="display:none">BackgroundColor</span><span data-if="cpp" style="display:none">BackgroundColor</span><span data-if="com" style="display:none">BackgroundColor</span><span data-if="dotnet" style="display:none">backgroundColor</span><span data-if="python" style="display:none">background_color</span></code></i></a> and <a href="#FatherWindow"><i><code><span data-if="hdevelop" style="display:inline">FatherWindow</span><span data-if="c" style="display:none">FatherWindow</span><span data-if="cpp" style="display:none">FatherWindow</span><span data-if="com" style="display:none">FatherWindow</span><span data-if="dotnet" style="display:none">fatherWindow</span><span data-if="python" style="display:none">father_window</span></code></i></a>
do not have any meaning.
You may use buffer windows, if you prepare output (in the background)
and copy it finally with <a href="copy_rectangle.html"><code><span data-if="hdevelop" style="display:inline">copy_rectangle</span><span data-if="c" style="display:none">copy_rectangle</span><span data-if="cpp" style="display:none">CopyRectangle</span><span data-if="com" style="display:none">CopyRectangle</span><span data-if="dotnet" style="display:none">CopyRectangle</span><span data-if="python" style="display:none">copy_rectangle</span></code></a> in a visible
window.
Another usage might be the rapid processing of image regions during
interactive manipulations.
Textual input and mouse interaction are not possible in this mode.
</p></dd>
</dl>
<h2 id="sec_attention">注意</h2>
<p>You have to keep in mind that parameters like <a href="#Row"><i><code><span data-if="hdevelop" style="display:inline">Row</span><span data-if="c" style="display:none">Row</span><span data-if="cpp" style="display:none">Row</span><span data-if="com" style="display:none">Row</span><span data-if="dotnet" style="display:none">row</span><span data-if="python" style="display:none">row</span></code></i></a>, <a href="#Column"><i><code><span data-if="hdevelop" style="display:inline">Column</span><span data-if="c" style="display:none">Column</span><span data-if="cpp" style="display:none">Column</span><span data-if="com" style="display:none">Column</span><span data-if="dotnet" style="display:none">column</span><span data-if="python" style="display:none">column</span></code></i></a>,
<a href="#Width"><i><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></i></a> and <a href="#Height"><i><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></i></a> are restricted by the
output device. Is a father window (<a href="#FatherWindow"><i><code><span data-if="hdevelop" style="display:inline">FatherWindow</span><span data-if="c" style="display:none">FatherWindow</span><span data-if="cpp" style="display:none">FatherWindow</span><span data-if="com" style="display:none">FatherWindow</span><span data-if="dotnet" style="display:none">fatherWindow</span><span data-if="python" style="display:none">father_window</span></code></i></a>  &lt;&gt;  'root')
specified, then the coordinates are relative to this window.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<p>This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.</p>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Row" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Row</span><span data-if="c" style="display:none">Row</span><span data-if="cpp" style="display:none">Row</span><span data-if="com" style="display:none">Row</span><span data-if="dotnet" style="display:none">row</span><span data-if="python" style="display:none">row</span></code></b> (input_control)  </span><span>rectangle.origin.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Row index of upper left corner.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>
    <span data-if="hdevelop" style="display:inline">Row</span>
    <span data-if="c" style="display:none">Row</span>
    <span data-if="cpp" style="display:none">Row</span>
    <span data-if="com" style="display:none">Row</span>
    <span data-if="dotnet" style="display:none">row</span>
    <span data-if="python" style="display:none">row</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Column" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Column</span><span data-if="c" style="display:none">Column</span><span data-if="cpp" style="display:none">Column</span><span data-if="com" style="display:none">Column</span><span data-if="dotnet" style="display:none">column</span><span data-if="python" style="display:none">column</span></code></b> (input_control)  </span><span>rectangle.origin.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Column index of upper left corner.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>
    <span data-if="hdevelop" style="display:inline">Column</span>
    <span data-if="c" style="display:none">Column</span>
    <span data-if="cpp" style="display:none">Column</span>
    <span data-if="com" style="display:none">Column</span>
    <span data-if="dotnet" style="display:none">column</span>
    <span data-if="python" style="display:none">column</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Width" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></b> (input_control)  </span><span>rectangle.extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Window's width.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>256</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Width</span>
    <span data-if="c" style="display:none">Width</span>
    <span data-if="cpp" style="display:none">Width</span>
    <span data-if="com" style="display:none">Width</span>
    <span data-if="dotnet" style="display:none">width</span>
    <span data-if="python" style="display:none">width</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Height" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></b> (input_control)  </span><span>rectangle.extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Window's height.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>256</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">Height</span>
    <span data-if="c" style="display:none">Height</span>
    <span data-if="cpp" style="display:none">Height</span>
    <span data-if="com" style="display:none">Height</span>
    <span data-if="dotnet" style="display:none">height</span>
    <span data-if="python" style="display:none">height</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="BorderWidth" class="parname"><b><code><span data-if="hdevelop" style="display:inline">BorderWidth</span><span data-if="c" style="display:none">BorderWidth</span><span data-if="cpp" style="display:none">BorderWidth</span><span data-if="com" style="display:none">BorderWidth</span><span data-if="dotnet" style="display:none">borderWidth</span><span data-if="python" style="display:none">border_width</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Window border's width.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>2</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">BorderWidth</span>
    <span data-if="c" style="display:none">BorderWidth</span>
    <span data-if="cpp" style="display:none">BorderWidth</span>
    <span data-if="com" style="display:none">BorderWidth</span>
    <span data-if="dotnet" style="display:none">borderWidth</span>
    <span data-if="python" style="display:none">border_width</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="BorderColor" class="parname"><b><code><span data-if="hdevelop" style="display:inline">BorderColor</span><span data-if="c" style="display:none">BorderColor</span><span data-if="cpp" style="display:none">BorderColor</span><span data-if="com" style="display:none">BorderColor</span><span data-if="dotnet" style="display:none">borderColor</span><span data-if="python" style="display:none">border_color</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Window border's color.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'white'</span>
    <span data-if="c" style="display:none">"white"</span>
    <span data-if="cpp" style="display:none">"white"</span>
    <span data-if="com" style="display:none">"white"</span>
    <span data-if="dotnet" style="display:none">"white"</span>
    <span data-if="python" style="display:none">"white"</span>
</p>
</div>
  <div class="par">
<div class="parhead">
<span id="BackgroundColor" class="parname"><b><code><span data-if="hdevelop" style="display:inline">BackgroundColor</span><span data-if="c" style="display:none">BackgroundColor</span><span data-if="cpp" style="display:none">BackgroundColor</span><span data-if="com" style="display:none">BackgroundColor</span><span data-if="dotnet" style="display:none">backgroundColor</span><span data-if="python" style="display:none">background_color</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Background color.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'black'</span>
    <span data-if="c" style="display:none">"black"</span>
    <span data-if="cpp" style="display:none">"black"</span>
    <span data-if="com" style="display:none">"black"</span>
    <span data-if="dotnet" style="display:none">"black"</span>
    <span data-if="python" style="display:none">"black"</span>
</p>
</div>
  <div class="par">
<div class="parhead">
<span id="FatherWindow" class="parname"><b><code><span data-if="hdevelop" style="display:inline">FatherWindow</span><span data-if="c" style="display:none">FatherWindow</span><span data-if="cpp" style="display:none">FatherWindow</span><span data-if="com" style="display:none">FatherWindow</span><span data-if="dotnet" style="display:none">fatherWindow</span><span data-if="python" style="display:none">father_window</span></code></b> (input_control)  </span><span>pointer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Union[int, str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer / </span><span data-if="hdevelop" style="display:inline">string)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i> / </span><span data-if="dotnet" style="display:none">IntPtr)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i> / </span><span data-if="cpp" style="display:none">HString)</span><span data-if="c" style="display:none"> (<i>Hlong</i> / </span><span data-if="c" style="display:none">char*)</span></span>
</div>
<p class="pardesc">Logical number of the father window. For the display
as father you may specify 'root' or 0.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>FatherWindow &gt;= 0</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Mode" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Window mode.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'visible'</span>
    <span data-if="c" style="display:none">"visible"</span>
    <span data-if="cpp" style="display:none">"visible"</span>
    <span data-if="com" style="display:none">"visible"</span>
    <span data-if="dotnet" style="display:none">"visible"</span>
    <span data-if="python" style="display:none">"visible"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'buffer'</span><span data-if="c" style="display:none">"buffer"</span><span data-if="cpp" style="display:none">"buffer"</span><span data-if="com" style="display:none">"buffer"</span><span data-if="dotnet" style="display:none">"buffer"</span><span data-if="python" style="display:none">"buffer"</span>, <span data-if="hdevelop" style="display:inline">'invisible'</span><span data-if="c" style="display:none">"invisible"</span><span data-if="cpp" style="display:none">"invisible"</span><span data-if="com" style="display:none">"invisible"</span><span data-if="dotnet" style="display:none">"invisible"</span><span data-if="python" style="display:none">"invisible"</span>, <span data-if="hdevelop" style="display:inline">'transparent'</span><span data-if="c" style="display:none">"transparent"</span><span data-if="cpp" style="display:none">"transparent"</span><span data-if="com" style="display:none">"transparent"</span><span data-if="dotnet" style="display:none">"transparent"</span><span data-if="python" style="display:none">"transparent"</span>, <span data-if="hdevelop" style="display:inline">'visible'</span><span data-if="c" style="display:none">"visible"</span><span data-if="cpp" style="display:none">"visible"</span><span data-if="com" style="display:none">"visible"</span><span data-if="dotnet" style="display:none">"visible"</span><span data-if="python" style="display:none">"visible"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Machine" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Machine</span><span data-if="c" style="display:none">Machine</span><span data-if="cpp" style="display:none">Machine</span><span data-if="com" style="display:none">Machine</span><span data-if="dotnet" style="display:none">machine</span><span data-if="python" style="display:none">machine</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Computer name, where the window has to be opened or
empty string.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">''</span>
    <span data-if="c" style="display:none">""</span>
    <span data-if="cpp" style="display:none">""</span>
    <span data-if="com" style="display:none">""</span>
    <span data-if="dotnet" style="display:none">""</span>
    <span data-if="python" style="display:none">""</span>
</p>
</div>
  <div class="par">
<div class="parhead">
<span id="WindowHandle" class="parname"><b><code><span data-if="hdevelop" style="display:inline">WindowHandle</span><span data-if="c" style="display:none">WindowHandle</span><span data-if="cpp" style="display:none">WindowHandle</span><span data-if="com" style="display:none">WindowHandle</span><span data-if="dotnet" style="display:none">windowHandle</span><span data-if="python" style="display:none">window_handle</span></code></b> (output_control)  </span><span>window <code>→</code> <span data-if="dotnet" style="display:none"><a href="HWindow.html">HWindow</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Window handle.</p>
</div>
<div data-if="hdevelop" style="display:inline">
<h2 id="sec_example_hdevelop">例程 (HDevelop)</h2>
<pre class="example">
open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)
</pre>
</div>
<div data-if="c" style="display:none">
<h2 id="sec_example_c">例程 (C)</h2>
<pre class="example">
open_textwindow(0,0,900,600,1,"black","slate blue","root","visible",
                "",&amp;WindowHandle1);
open_textwindow(10,10,300,580,3,"red","blue",Father,"visible",
                "",&amp;WindowHandle2);
open_window(10,320,570,580,Father,"visible","",&amp;WindowHandle);
set_color(WindowHandle,"red");
read_image(&amp;Image,"monkey");
disp_image(Image,WindowHandle);
create_tuple(&amp;String,1);
do {
  get_mposition(WindowHandle,&amp;Row,&amp;Column,&amp;Button);
  get_grayval(Image,Row,Column,&amp;Gray);
  sprintf(buf,"Position( %d,%d ) ",Row,Column);
  set_s(String,buf,0);
  T_fwrite_string(String);
  new_line(WindowHandle);
}
while(Button &lt; 4);
close_window(WindowHandle);
</pre>
</div>
<div data-if="cpp" style="display:none">
<h2 id="sec_example_cpp">例程 (HDevelop)</h2>
<pre class="example">
open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)
</pre>
</div>
<div data-if="com" style="display:none">
<h2 id="sec_example_com">例程 (HDevelop)</h2>
<pre class="example">
open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)
</pre>
</div>
<div data-if="dotnet" style="display:none">
<h2 id="sec_example_dotnet">例程 (HDevelop)</h2>
<pre class="example">
open_textwindow(0,0,900,600,1,'black','slate blue','root','visible', \
              '',WindowHandle1)
open_textwindow(10,10,300,580,3,'red','blue',WindowHandle1,'visible', \
              '',WindowHandle2)
open_window(10,320,570,580,WindowHandle1,'visible','',WindowHandle)
set_color(WindowHandle,'red')
read_image(Image,'monkey')
disp_image(Image,WindowHandle)
Button := 0
repeat
  try
      get_mposition(WindowHandle,Row,Column,Button)
      get_grayval(Image,Row,Column,Gray)
      write_string(WindowHandle2,['  Position (',Row,',',Column,')  '])
      write_string(WindowHandle2,['Gray value (',Gray,')  '])
      new_line(WindowHandle2)
  catch (Exception)
  endtry
until(Button == 4)
close_window(WindowHandle1)
</pre>
</div>
<h2 id="sec_result">结果</h2>
<p>If the values of the specified parameters are correct
<code><span data-if="hdevelop" style="display:inline">open_textwindow</span><span data-if="c" style="display:none">open_textwindow</span><span data-if="cpp" style="display:none">OpenTextwindow</span><span data-if="com" style="display:none">OpenTextwindow</span><span data-if="dotnet" style="display:none">OpenTextwindow</span><span data-if="python" style="display:none">open_textwindow</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .
If necessary an exception is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="reset_obj_db.html"><span data-if="hdevelop" style="display:inline">reset_obj_db</span><span data-if="c" style="display:none">reset_obj_db</span><span data-if="cpp" style="display:none">ResetObjDb</span><span data-if="com" style="display:none">ResetObjDb</span><span data-if="dotnet" style="display:none">ResetObjDb</span><span data-if="python" style="display:none">reset_obj_db</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="set_color.html"><span data-if="hdevelop" style="display:inline">set_color</span><span data-if="c" style="display:none">set_color</span><span data-if="cpp" style="display:none">SetColor</span><span data-if="com" style="display:none">SetColor</span><span data-if="dotnet" style="display:none">SetColor</span><span data-if="python" style="display:none">set_color</span></a></code>, 
<code><a href="query_window_type.html"><span data-if="hdevelop" style="display:inline">query_window_type</span><span data-if="c" style="display:none">query_window_type</span><span data-if="cpp" style="display:none">QueryWindowType</span><span data-if="com" style="display:none">QueryWindowType</span><span data-if="dotnet" style="display:none">QueryWindowType</span><span data-if="python" style="display:none">query_window_type</span></a></code>, 
<code><a href="get_window_type.html"><span data-if="hdevelop" style="display:inline">get_window_type</span><span data-if="c" style="display:none">get_window_type</span><span data-if="cpp" style="display:none">GetWindowType</span><span data-if="com" style="display:none">GetWindowType</span><span data-if="dotnet" style="display:none">GetWindowType</span><span data-if="python" style="display:none">get_window_type</span></a></code>, 
<code><a href="set_window_type.html"><span data-if="hdevelop" style="display:inline">set_window_type</span><span data-if="c" style="display:none">set_window_type</span><span data-if="cpp" style="display:none">SetWindowType</span><span data-if="com" style="display:none">SetWindowType</span><span data-if="dotnet" style="display:none">SetWindowType</span><span data-if="python" style="display:none">set_window_type</span></a></code>, 
<code><a href="get_mposition.html"><span data-if="hdevelop" style="display:inline">get_mposition</span><span data-if="c" style="display:none">get_mposition</span><span data-if="cpp" style="display:none">GetMposition</span><span data-if="com" style="display:none">GetMposition</span><span data-if="dotnet" style="display:none">GetMposition</span><span data-if="python" style="display:none">get_mposition</span></a></code>, 
<code><a href="set_tposition.html"><span data-if="hdevelop" style="display:inline">set_tposition</span><span data-if="c" style="display:none">set_tposition</span><span data-if="cpp" style="display:none">SetTposition</span><span data-if="com" style="display:none">SetTposition</span><span data-if="dotnet" style="display:none">SetTposition</span><span data-if="python" style="display:none">set_tposition</span></a></code>, 
<code><a href="set_tshape.html"><span data-if="hdevelop" style="display:inline">set_tshape</span><span data-if="c" style="display:none">set_tshape</span><span data-if="cpp" style="display:none">SetTshape</span><span data-if="com" style="display:none">SetTshape</span><span data-if="dotnet" style="display:none">SetTshape</span><span data-if="python" style="display:none">set_tshape</span></a></code>, 
<code><a href="set_window_extents.html"><span data-if="hdevelop" style="display:inline">set_window_extents</span><span data-if="c" style="display:none">set_window_extents</span><span data-if="cpp" style="display:none">SetWindowExtents</span><span data-if="com" style="display:none">SetWindowExtents</span><span data-if="dotnet" style="display:none">SetWindowExtents</span><span data-if="python" style="display:none">set_window_extents</span></a></code>, 
<code><a href="get_window_extents.html"><span data-if="hdevelop" style="display:inline">get_window_extents</span><span data-if="c" style="display:none">get_window_extents</span><span data-if="cpp" style="display:none">GetWindowExtents</span><span data-if="com" style="display:none">GetWindowExtents</span><span data-if="dotnet" style="display:none">GetWindowExtents</span><span data-if="python" style="display:none">get_window_extents</span></a></code>, 
<code><a href="query_color.html"><span data-if="hdevelop" style="display:inline">query_color</span><span data-if="c" style="display:none">query_color</span><span data-if="cpp" style="display:none">QueryColor</span><span data-if="com" style="display:none">QueryColor</span><span data-if="dotnet" style="display:none">QueryColor</span><span data-if="python" style="display:none">query_color</span></a></code>, 
<code><a href="set_check.html"><span data-if="hdevelop" style="display:inline">set_check</span><span data-if="c" style="display:none">set_check</span><span data-if="cpp" style="display:none">SetCheck</span><span data-if="com" style="display:none">SetCheck</span><span data-if="dotnet" style="display:none">SetCheck</span><span data-if="python" style="display:none">set_check</span></a></code>, 
<code><a href="set_system.html"><span data-if="hdevelop" style="display:inline">set_system</span><span data-if="c" style="display:none">set_system</span><span data-if="cpp" style="display:none">SetSystem</span><span data-if="com" style="display:none">SetSystem</span><span data-if="dotnet" style="display:none">SetSystem</span><span data-if="python" style="display:none">set_system</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="open_window.html"><span data-if="hdevelop" style="display:inline">open_window</span><span data-if="c" style="display:none">open_window</span><span data-if="cpp" style="display:none">OpenWindow</span><span data-if="com" style="display:none">OpenWindow</span><span data-if="dotnet" style="display:none">OpenWindow</span><span data-if="python" style="display:none">open_window</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="write_string.html"><span data-if="hdevelop" style="display:inline">write_string</span><span data-if="c" style="display:none">write_string</span><span data-if="cpp" style="display:none">WriteString</span><span data-if="com" style="display:none">WriteString</span><span data-if="dotnet" style="display:none">WriteString</span><span data-if="python" style="display:none">write_string</span></a></code>, 
<code><a href="read_string.html"><span data-if="hdevelop" style="display:inline">read_string</span><span data-if="c" style="display:none">read_string</span><span data-if="cpp" style="display:none">ReadString</span><span data-if="com" style="display:none">ReadString</span><span data-if="dotnet" style="display:none">ReadString</span><span data-if="python" style="display:none">read_string</span></a></code>, 
<code><a href="new_line.html"><span data-if="hdevelop" style="display:inline">new_line</span><span data-if="c" style="display:none">new_line</span><span data-if="cpp" style="display:none">NewLine</span><span data-if="com" style="display:none">NewLine</span><span data-if="dotnet" style="display:none">NewLine</span><span data-if="python" style="display:none">new_line</span></a></code>, 
<code><a href="get_string_extents.html"><span data-if="hdevelop" style="display:inline">get_string_extents</span><span data-if="c" style="display:none">get_string_extents</span><span data-if="cpp" style="display:none">GetStringExtents</span><span data-if="com" style="display:none">GetStringExtents</span><span data-if="dotnet" style="display:none">GetStringExtents</span><span data-if="python" style="display:none">get_string_extents</span></a></code>, 
<code><a href="get_tposition.html"><span data-if="hdevelop" style="display:inline">get_tposition</span><span data-if="c" style="display:none">get_tposition</span><span data-if="cpp" style="display:none">GetTposition</span><span data-if="com" style="display:none">GetTposition</span><span data-if="dotnet" style="display:none">GetTposition</span><span data-if="python" style="display:none">get_tposition</span></a></code>, 
<code><a href="set_color.html"><span data-if="hdevelop" style="display:inline">set_color</span><span data-if="c" style="display:none">set_color</span><span data-if="cpp" style="display:none">SetColor</span><span data-if="com" style="display:none">SetColor</span><span data-if="dotnet" style="display:none">SetColor</span><span data-if="python" style="display:none">set_color</span></a></code>, 
<code><a href="query_window_type.html"><span data-if="hdevelop" style="display:inline">query_window_type</span><span data-if="c" style="display:none">query_window_type</span><span data-if="cpp" style="display:none">QueryWindowType</span><span data-if="com" style="display:none">QueryWindowType</span><span data-if="dotnet" style="display:none">QueryWindowType</span><span data-if="python" style="display:none">query_window_type</span></a></code>, 
<code><a href="get_window_type.html"><span data-if="hdevelop" style="display:inline">get_window_type</span><span data-if="c" style="display:none">get_window_type</span><span data-if="cpp" style="display:none">GetWindowType</span><span data-if="com" style="display:none">GetWindowType</span><span data-if="dotnet" style="display:none">GetWindowType</span><span data-if="python" style="display:none">get_window_type</span></a></code>, 
<code><a href="set_window_type.html"><span data-if="hdevelop" style="display:inline">set_window_type</span><span data-if="c" style="display:none">set_window_type</span><span data-if="cpp" style="display:none">SetWindowType</span><span data-if="com" style="display:none">SetWindowType</span><span data-if="dotnet" style="display:none">SetWindowType</span><span data-if="python" style="display:none">set_window_type</span></a></code>, 
<code><a href="get_mposition.html"><span data-if="hdevelop" style="display:inline">get_mposition</span><span data-if="c" style="display:none">get_mposition</span><span data-if="cpp" style="display:none">GetMposition</span><span data-if="com" style="display:none">GetMposition</span><span data-if="dotnet" style="display:none">GetMposition</span><span data-if="python" style="display:none">get_mposition</span></a></code>, 
<code><a href="set_tposition.html"><span data-if="hdevelop" style="display:inline">set_tposition</span><span data-if="c" style="display:none">set_tposition</span><span data-if="cpp" style="display:none">SetTposition</span><span data-if="com" style="display:none">SetTposition</span><span data-if="dotnet" style="display:none">SetTposition</span><span data-if="python" style="display:none">set_tposition</span></a></code>, 
<code><a href="set_tshape.html"><span data-if="hdevelop" style="display:inline">set_tshape</span><span data-if="c" style="display:none">set_tshape</span><span data-if="cpp" style="display:none">SetTshape</span><span data-if="com" style="display:none">SetTshape</span><span data-if="dotnet" style="display:none">SetTshape</span><span data-if="python" style="display:none">set_tshape</span></a></code>, 
<code><a href="set_window_extents.html"><span data-if="hdevelop" style="display:inline">set_window_extents</span><span data-if="c" style="display:none">set_window_extents</span><span data-if="cpp" style="display:none">SetWindowExtents</span><span data-if="com" style="display:none">SetWindowExtents</span><span data-if="dotnet" style="display:none">SetWindowExtents</span><span data-if="python" style="display:none">set_window_extents</span></a></code>, 
<code><a href="get_window_extents.html"><span data-if="hdevelop" style="display:inline">get_window_extents</span><span data-if="c" style="display:none">get_window_extents</span><span data-if="cpp" style="display:none">GetWindowExtents</span><span data-if="com" style="display:none">GetWindowExtents</span><span data-if="dotnet" style="display:none">GetWindowExtents</span><span data-if="python" style="display:none">get_window_extents</span></a></code>, 
<code><a href="query_color.html"><span data-if="hdevelop" style="display:inline">query_color</span><span data-if="c" style="display:none">query_color</span><span data-if="cpp" style="display:none">QueryColor</span><span data-if="com" style="display:none">QueryColor</span><span data-if="dotnet" style="display:none">QueryColor</span><span data-if="python" style="display:none">query_color</span></a></code>, 
<code><a href="set_check.html"><span data-if="hdevelop" style="display:inline">set_check</span><span data-if="c" style="display:none">set_check</span><span data-if="cpp" style="display:none">SetCheck</span><span data-if="com" style="display:none">SetCheck</span><span data-if="dotnet" style="display:none">SetCheck</span><span data-if="python" style="display:none">set_check</span></a></code>, 
<code><a href="set_system.html"><span data-if="hdevelop" style="display:inline">set_system</span><span data-if="c" style="display:none">set_system</span><span data-if="cpp" style="display:none">SetSystem</span><span data-if="com" style="display:none">SetSystem</span><span data-if="dotnet" style="display:none">SetSystem</span><span data-if="python" style="display:none">set_system</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
